home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / documents / RFC / rfc1229.txt < prev    next >
Text File  |  1994-08-01  |  35KB  |  899 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                              K. McCloghrie, Editor
  8. Request for Comments: 1229                      Hughes LAN Systems, Inc.
  9.                                                                 May 1991
  10.  
  11.  
  12.                 Extensions to the Generic-Interface MIB
  13.  
  14. Status of this Memo
  15.  
  16.    This RFC contains definitions of managed objects used as experimental
  17.    extensions to the generic interfaces structure of MIB-II.  This memo
  18.    is a product of the SNMP Working Group of the Internet Engineering
  19.    Task Force (IETF).  This RFC specifies an IAB standards track
  20.    protocol for the Internet community, and requests discussion and
  21.    suggestions for improvements.  Please refer to the current edition of
  22.    the "IAB Official Protocol Standards" for the standardization state
  23.    and status of this protocol.  Distribution of this memo is unlimited.
  24.  
  25. Table of Contents
  26.  
  27.    1. Abstract ..............................................    1
  28.    2. The Network Management Framework.......................    1
  29.    3. Objects ...............................................    2
  30.    4. Overview ..............................................    3
  31.    4.1 Generic Interface Extension Table ....................    3
  32.    4.2 Generic Interface Test Table .........................    3
  33.    4.3 Generic Receive Address Table ........................    4
  34.    5. Definitions ...........................................    5
  35.    6. Acknowledgements ......................................   14
  36.    7. References ............................................   15
  37.    8. Security Considerations................................   15
  38.    9. Author's Address.......................................   16
  39.  
  40. 1.  Abstract
  41.  
  42.    This memo defines an experimental portion of the Management
  43.    Information Base (MIB) for use with network management protocols in
  44.    TCP/IP-based internets.  In particular, it defines managed object
  45.    types as experimental extensions to the generic interfaces structure
  46.    of MIB-II.
  47.  
  48. 2.  The Network Management Framework
  49.  
  50.    The Internet-standard Network Management Framework consists of three
  51.    components.  They are:
  52.  
  53.       RFC 1155 which defines the SMI, the mechanisms used for describing
  54.       and naming objects for the purpose of management.  RFC 1212
  55.  
  56.  
  57.  
  58. SNMP Working Group                                              [Page 1]
  59.  
  60. RFC 1229                Interface MIB Extensions                May 1991
  61.  
  62.  
  63.       defines a more concise description mechanism, which is wholly
  64.       consistent with the SMI.
  65.  
  66.       RFC 1156 which defines MIB-I, the core set of managed objects for
  67.       the Internet suite of protocols.  RFC 1213, defines MIB-II, an
  68.       evolution of MIB-I based on implementation experience and new
  69.       operational requirements.
  70.  
  71.       RFC 1157 which defines the SNMP, the protocol used for network
  72.       access to managed objects.
  73.  
  74.    The Framework permits new objects to be defined for the purpose of
  75.    experimentation and evaluation.
  76.  
  77. 3.  Objects
  78.  
  79.    Managed objects are accessed via a virtual information store, termed
  80.    the Management Information Base or MIB.  Objects in the MIB are
  81.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  82.    defined in the SMI.  In particular, each object has a name, a syntax,
  83.    and an encoding.  The name is an object identifier, an
  84.    administratively assigned name, which specifies an object type.  The
  85.    object type together with an object instance serves to uniquely
  86.    identify a specific instantiation of the object.  For human
  87.    convenience, we often use a textual string, termed the OBJECT
  88.    DESCRIPTOR, to also refer to the object type.
  89.  
  90.    The syntax of an object type defines the abstract data structure
  91.    corresponding to that object type.  The ASN.1 language is used for
  92.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  93.    constructs which may be used.  These restrictions are explicitly made
  94.    for simplicity.
  95.  
  96.    The encoding of an object type is simply how that object type is
  97.    represented using the object type's syntax.  Implicitly tied to the
  98.    notion of an object type's syntax and encoding is how the object type
  99.    is represented when being transmitted on the network.
  100.  
  101.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  102.    subject to the additional requirements imposed by the SNMP.
  103.  
  104.    Section 5 contains the specification of all object types in this
  105.    section of the MIB.  The object types are defined using the
  106.    conventions specified in the SMI, as amended by the extensions
  107.    specified in [9].
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. SNMP Working Group                                              [Page 2]
  115.  
  116. RFC 1229                Interface MIB Extensions                May 1991
  117.  
  118.  
  119. 4.  Overview
  120.  
  121.    The Internet Standard MIB [4,6] contains a group of management
  122.    objects pertaining to a network device's generic network
  123.    interface(s).  These objects are generic in the sense that they apply
  124.    to all network interfaces, irrespective of the type of communication
  125.    media and protocols used on such interfaces.  This has proved to be
  126.    necessary but not sufficient; there are efforts underway to define
  127.    additional MIB objects which are specific to particular media and
  128.    lower-level (subnetwork-layer and below) protocol stacks.
  129.  
  130.    However, some of these efforts have identified objects which are
  131.    required (or at least useful), but are not specific to the
  132.    interface-type on which the effort is focusing.  In order to avoid
  133.    redundancy, it is better that such objects be defined as extensions
  134.    to the generic interface group, rather than defined in multiple
  135.    specific-interface-type MIBs.
  136.  
  137.    This memo defines the resultant extensions to the generic interface
  138.    group.  These extensions are spread over three tables: the generic
  139.    Interface Extension table, the generic Interface Test table, and the
  140.    generic Receive Address table.
  141.  
  142. 4.1.  Generic Interface Extension Table
  143.  
  144.    This table consists of new objects applicable to all types of
  145.    subnetwork interface.
  146.  
  147. 4.2.  Generic Interface Test Table
  148.  
  149.    This section defines objects which allow a network manager to
  150.    instruct an agent to test an interface for various faults.  A few
  151.    common types of tests are defined in this document but most will be
  152.    defined elsewhere, dependent on the particular type of interface.
  153.    After testing, the object ifExtnsTestResult can be read to determine
  154.    the outcome.  If an agent cannot perform the test, ifExtnsTestResult
  155.    is set to so indicate.  The object ifExtnsTestCode can be used to
  156.    provide further test-specific or interface-specific (or even
  157.    enterprise-specific) information concerning the outcome of the test.
  158.    Only one test can be in progress on each interface at any one time.
  159.    If one test is in progress when another test is invoked, the second
  160.    test is rejected.  Some agents may reject a test when a prior test is
  161.    active on another interface.
  162.  
  163.    When a test is invoked, the identity of the originator of the request
  164.    and the request-id are saved by the agent in the objects
  165.    ifExtnsTestRequestId and ifExtnsTestCommunity.  These values remain
  166.    set until the next test is invoked.  In the (rare) event that the
  167.  
  168.  
  169.  
  170. SNMP Working Group                                              [Page 3]
  171.  
  172. RFC 1229                Interface MIB Extensions                May 1991
  173.  
  174.  
  175.    invocation of tests by two network managers were to overlap, then
  176.    there would be a possibility that the first test's results might be
  177.    overwritten by the second test's results prior to the first results
  178.    being read.  This unlikely circumstance can be detected by a network
  179.    manager retrieving ifExtnsTestCommunity, and ifExtnsTestRequestId at
  180.    the same time as the test results are retrieved, and ensuring that
  181.    the results are for the desired request.
  182.  
  183.    In general, a Management station must not retransmit a request to
  184.    invoke a test for which it does not receive a response; instead, it
  185.    properly inspects an agent's MIB to determine if the invocation was
  186.    successful.  The invocation request is retransmitted only if the
  187.    invocation was unsuccessful.
  188.  
  189.    Some tests may require the interface to be taken off-line or may even
  190.    require the agent to be rebooted after completion of the test.  In
  191.    these circumstances, communication with the management station
  192.    invoking the test may be lost until after completion of the test.
  193.    The agent should make every effort to transmit a response to the
  194.    request that invoked the test prior to losing communication.  When
  195.    the agent is restored to normal service, the results of the test are
  196.    properly made available in the appropriate objects.  Note that this
  197.    requires that the ifIndex value assigned to an interface must be
  198.    unchanged even if the test causes a reboot.  An agent must reject any
  199.    test for which it cannot, perhaps due to resource constraints, make
  200.    available at least the minimum amount of information after that test
  201.    completes.
  202.  
  203. 4.3.  Generic Receive Address Table
  204.  
  205.    This table contains objects relating to an interface's support for
  206.    receiving packets/frames at more than one address on the same
  207.    interface.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. SNMP Working Group                                              [Page 4]
  227.  
  228. RFC 1229                Interface MIB Extensions                May 1991
  229.  
  230.  
  231. 5.  Definitions
  232.  
  233.  
  234.           RFC1229-MIB DEFINITIONS ::= BEGIN
  235.  
  236.  
  237.           --        Extensions to MIB-II's Generic Interface Table
  238.  
  239.           IMPORTS
  240.                   experimental, Counter         FROM RFC1155-SMI
  241.                   DisplayString, PhysAddress    FROM RFC1213-MIB
  242.                   OBJECT-TYPE                   FROM RFC-1212;
  243.  
  244.  
  245.  
  246.           ifExtensions  OBJECT IDENTIFIER ::= { experimental 6 }
  247.  
  248.  
  249.           --   Generic Interface Extension Table
  250.           --
  251.           --  This group of objects is mandatory for all types of
  252.           --  subnetwork interface.
  253.  
  254.           ifExtnsTable  OBJECT-TYPE
  255.                   SYNTAX SEQUENCE OF IfExtnsEntry
  256.                   ACCESS not-accessible
  257.                   STATUS mandatory
  258.                   DESCRIPTION
  259.                          "A list of interfaces extension entries.
  260.                           The number of entries is given by the value
  261.                           of ifNumber, defined in [4,6]."
  262.                   ::= { ifExtensions 1 }
  263.  
  264.           ifExtnsEntry  OBJECT-TYPE
  265.                   SYNTAX IfExtnsEntry
  266.                   ACCESS not-accessible
  267.                   STATUS mandatory
  268.                   DESCRIPTION
  269.                          "An extension to the interfaces entry,
  270.                           defined in [4,6], containing additional
  271.                           objects at the subnetwork layer and below
  272.                           for a particular interface."
  273.                   INDEX  { ifExtnsIfIndex }
  274.                   ::= { ifExtnsTable 1 }
  275.  
  276.           IfExtnsEntry ::=
  277.                   SEQUENCE {
  278.                       ifExtnsIfIndex
  279.  
  280.  
  281.  
  282. SNMP Working Group                                              [Page 5]
  283.  
  284. RFC 1229                Interface MIB Extensions                May 1991
  285.  
  286.  
  287.                           INTEGER,
  288.                       ifExtnsChipSet
  289.                           OBJECT IDENTIFIER,
  290.                       ifExtnsRevWare
  291.                           DisplayString,
  292.                       ifExtnsMulticastsTransmittedOks
  293.                           Counter,
  294.                       ifExtnsBroadcastsTransmittedOks
  295.                           Counter,
  296.                       ifExtnsMulticastsReceivedOks
  297.                           Counter,
  298.                       ifExtnsBroadcastsReceivedOks
  299.                           Counter,
  300.                       ifExtnsPromiscuous
  301.                           INTEGER
  302.                   }
  303.  
  304.           ifExtnsIfIndex  OBJECT-TYPE
  305.                   SYNTAX INTEGER
  306.                   ACCESS read-only
  307.                   STATUS mandatory
  308.                   DESCRIPTION
  309.                          "The value of this object identifies the
  310.                           interface for which this entry contains
  311.                           extended management information.  The value
  312.                           of this object for a particular interface
  313.                           has the same value as the ifIndex object,
  314.                           defined in [4,6], for the same interface."
  315.                   ::= { ifExtnsEntry 1 }
  316.  
  317.           ifExtnsChipSet  OBJECT-TYPE
  318.                   SYNTAX OBJECT IDENTIFIER
  319.                   ACCESS read-only
  320.                   STATUS mandatory
  321.                   DESCRIPTION
  322.                          "This object identifies the hardware chip
  323.                           set being used in the interface.  The
  324.                           assignment of OBJECT IDENTIFIERs to various
  325.                           types of hardware chip sets is managed
  326.                           by the IANA.  If the hardware chip set is
  327.                           unknown, the object identifier
  328.  
  329.                           unknownChipSet OBJECT IDENTIFIER ::= { 0 0 }
  330.  
  331.                           is returned.  Note that unknownChipSet is a
  332.                           syntactically valid object identifier, and
  333.                           any conformant implementation of ASN.1 and
  334.                           the BER must be able to generate and
  335.  
  336.  
  337.  
  338. SNMP Working Group                                              [Page 6]
  339.  
  340. RFC 1229                Interface MIB Extensions                May 1991
  341.  
  342.  
  343.                           recognize this value."
  344.                   ::= { ifExtnsEntry 2 }
  345.  
  346.           ifExtnsRevWare  OBJECT-TYPE
  347.                   SYNTAX DisplayString (SIZE (0..255))
  348.                   ACCESS read-only
  349.                   STATUS mandatory
  350.                   DESCRIPTION
  351.                          "An arbitrary octet string that describes
  352.                           the firmware version of this interface.
  353.                           It is intended that this should be human
  354.                           readable.  It must only contain ASCII
  355.                           printable characters.  Typically this
  356.                           will be the firmware version of the main
  357.                           interface software."
  358.                   ::= { ifExtnsEntry 3 }
  359.  
  360.           ifExtnsMulticastsTransmittedOks OBJECT-TYPE
  361.                   SYNTAX Counter
  362.                   ACCESS read-only
  363.                   STATUS mandatory
  364.                   DESCRIPTION
  365.                          "The count of frames successfully
  366.                           transmitted to a subnetwork or link-layer
  367.                           multicast destination address other than a
  368.                           broadcast address.  For a MAC layer protocol,
  369.                           this includes both Group and Functional
  370.                           addresses."
  371.                   ::= { ifExtnsEntry 4 }
  372.  
  373.           ifExtnsBroadcastsTransmittedOks OBJECT-TYPE
  374.                   SYNTAX Counter
  375.                   ACCESS read-only
  376.                   STATUS mandatory
  377.                   DESCRIPTION
  378.                          "The count of frames successfully
  379.                           transmitted to a subnetwork or link-layer
  380.                           broadcast addresses.  It does not include
  381.                           frames sent to a multicast address."
  382.                   ::= { ifExtnsEntry 5 }
  383.  
  384.           ifExtnsMulticastsReceivedOks OBJECT-TYPE
  385.                   SYNTAX Counter
  386.                   ACCESS read-only
  387.                   STATUS mandatory
  388.                   DESCRIPTION
  389.                          "The count of frames successfully received
  390.                           that are directed to an active subnetwork
  391.  
  392.  
  393.  
  394. SNMP Working Group                                              [Page 7]
  395.  
  396. RFC 1229                Interface MIB Extensions                May 1991
  397.  
  398.  
  399.                           or link-layer multicast address (for a MAC
  400.                           layer protocol, this includes both Group and
  401.                           Functional addresses). This does not include
  402.                           frames directed to a broadcast address, nor
  403.                           frames received with errors."
  404.                   ::= { ifExtnsEntry 6 }
  405.  
  406.           ifExtnsBroadcastsReceivedOks OBJECT-TYPE
  407.                   SYNTAX Counter
  408.                   ACCESS read-only
  409.                   STATUS mandatory
  410.                   DESCRIPTION
  411.                          "The count of frames successfully received
  412.                           that are directed to a subnetwork or
  413.                           link-layer broadcast address.  This does not
  414.                           include frames received with errors."
  415.                   ::= { ifExtnsEntry 7 }
  416.  
  417.           ifExtnsPromiscuous  OBJECT-TYPE
  418.                   SYNTAX INTEGER {
  419.                               true(1),
  420.                               false(2)
  421.                          }
  422.                   ACCESS read-only  -- Note: agent implementors are
  423.                                     -- encouraged to extend this
  424.                                     -- access to read-write if that
  425.                                     -- makes sense in their agent.
  426.                   STATUS mandatory
  427.                   DESCRIPTION
  428.                          "This object has a value of false(2) if
  429.                           this interface only accepts packets/frames
  430.                           that are addressed to this station. This
  431.                           object has a value of true(1) when the
  432.                           station accepts all packets/frames
  433.                           transmitted on the media.  The value
  434.                           true(1) is only legal on certain types of
  435.                           media.  If legal, setting this object to a
  436.                           value of true(1) may require the interface
  437.                           to be reset before becoming effective."
  438.                   ::= { ifExtnsEntry 8 }
  439.  
  440.           --
  441.           --    Generic Interface Test Table
  442.           --
  443.           -- This group of objects is optional, but if the table is
  444.           -- implemented, all objects in the table must be implemented.
  445.  
  446.  
  447.  
  448.  
  449.  
  450. SNMP Working Group                                              [Page 8]
  451.  
  452. RFC 1229                Interface MIB Extensions                May 1991
  453.  
  454.  
  455.           ifExtnsTestTable   OBJECT-TYPE
  456.  
  457.                   SYNTAX  SEQUENCE OF IfExtnsTestEntry
  458.                   ACCESS  not-accessible
  459.                   STATUS  mandatory
  460.                   DESCRIPTION
  461.                           "This table contains one entry per interface."
  462.                   ::= { ifExtensions 2 }
  463.  
  464.           ifExtnsTestEntry OBJECT-TYPE
  465.                   SYNTAX  IfExtnsTestEntry
  466.                   ACCESS  not-accessible
  467.                   STATUS  mandatory
  468.                   DESCRIPTION
  469.                           "An entry containing objects for invoking
  470.                            tests on an interface."
  471.                   INDEX   { ifExtnsTestIfIndex }
  472.                   ::= { ifExtnsTestTable 1 }
  473.  
  474.           IfExtnsTestEntry ::=
  475.                   SEQUENCE {
  476.                       ifExtnsTestIfIndex
  477.                           INTEGER,
  478.                       ifExtnsTestCommunity
  479.                           OCTET STRING,
  480.                       ifExtnsTestRequestId
  481.                           INTEGER,
  482.                       ifExtnsTestType
  483.                           OBJECT IDENTIFIER,
  484.                       ifExtnsTestResult
  485.                           INTEGER,
  486.                       ifExtnsTestCode
  487.                           OBJECT IDENTIFIER
  488.                   }
  489.  
  490.           ifExtnsTestIfIndex  OBJECT-TYPE
  491.                   SYNTAX  INTEGER
  492.                   ACCESS  read-only
  493.                   STATUS  mandatory
  494.                   DESCRIPTION
  495.                          "The value of this object identifies the
  496.                           interface for which this entry contains
  497.                           information on interface tests.  The value
  498.                           of this object for a particular interface
  499.                           has the same value as the ifIndex object,
  500.                           defined in [4,6], for the same interface."
  501.                   ::= { ifExtnsTestEntry 1 }
  502.  
  503.  
  504.  
  505.  
  506. SNMP Working Group                                              [Page 9]
  507.  
  508. RFC 1229                Interface MIB Extensions                May 1991
  509.  
  510.  
  511.           ifExtnsTestCommunity  OBJECT-TYPE
  512.                   SYNTAX  OCTET STRING
  513.                   ACCESS  read-only
  514.                   STATUS  mandatory
  515.                   DESCRIPTION
  516.                          "This object contains the name of the SNMP
  517.                           authentication community [5] which was used
  518.                           to authenticate the SNMP Message which invoked
  519.                           the current or most recent test on this
  520.                           interface.  If the authentication community
  521.                           is unknown or undefined, this value contains
  522.                           the zero-length string."
  523.                   ::= { ifExtnsTestEntry 2 }
  524.  
  525.           ifExtnsTestRequestId  OBJECT-TYPE
  526.                   SYNTAX  INTEGER
  527.                   ACCESS  read-only
  528.                   STATUS  mandatory
  529.                   DESCRIPTION
  530.                          "This object contains the value of the
  531.                           request-id field in the SNMP PDU [5] which
  532.                           invoked the current or most recent test on
  533.                           this interface.  If the request-id is
  534.                           unknown or undefined, this value contains
  535.                           the value zero."
  536.                   ::= { ifExtnsTestEntry 3 }
  537.  
  538.           ifExtnsTestType  OBJECT-TYPE
  539.                   SYNTAX  OBJECT IDENTIFIER
  540.                   ACCESS  read-write
  541.                   STATUS  mandatory
  542.                   DESCRIPTION
  543.                          "A control variable used to start and stop
  544.                           operator-initiated interface tests.
  545.                               Most OBJECT IDENTIFIER values assigned
  546.                           to tests are defined elsewhere, in associ-
  547.                           ation with specific types of interface.
  548.                           However, this document assigns a value for
  549.                           a full-duplex loopback test, and defines the
  550.                           special meanings of the subject identifier:
  551.  
  552.                             noTest  OBJECT IDENTIFIER ::= { 0 0 }
  553.  
  554.                           When the value noTest is written to this
  555.                           object, no action is taken unless a test is
  556.                           in progress, in which case the test is
  557.                           aborted.  Writing any other value to this
  558.                           object is only valid when no test is
  559.  
  560.  
  561.  
  562. SNMP Working Group                                             [Page 10]
  563.  
  564. RFC 1229                Interface MIB Extensions                May 1991
  565.  
  566.  
  567.                           currently in progress, in which case the
  568.                           indicated test is initiated.
  569.                               Note that noTest is a syntactically valid
  570.                           object identifier, and any conformant
  571.                           implementation of ASN.1 and BER must be able
  572.                           to generate and recognize this value.
  573.                               When read, this object always returns
  574.                           the most recent value that ifExtnsTestType
  575.                           was set to.  If it has not been set since
  576.                           the last initialization of the network
  577.                           management subsystem on the agent, a value
  578.                           of noTest is returned."
  579.                   ::= { ifExtnsTestEntry 4 }
  580.  
  581.           wellKnownTests OBJECT IDENTIFIER ::= { ifExtensions 4 }
  582.  
  583.           --  full-duplex loopback test
  584.           testFullDuplexLoopBack OBJECT IDENTIFIER ::=
  585.                                                   { wellKnownTests 1 }
  586.  
  587.           ifExtnsTestResult  OBJECT-TYPE
  588.                   SYNTAX  INTEGER {
  589.                               none(1),        -- no test yet requested
  590.                               success(2),
  591.                               inProgress(3),
  592.                               notSupported(4),
  593.                               unAbleToRun(5), -- due to state of system
  594.                               aborted(6),
  595.                               failed(7)
  596.                           }
  597.                   ACCESS  read-only
  598.                   STATUS  mandatory
  599.                   DESCRIPTION
  600.                          "This object contains the result of the most
  601.                           recently requested test, or the value
  602.                           none(1) if no tests have been requested since
  603.                           the last reset.  Note that this facility
  604.                           provides no provision for saving the results
  605.                           of one test when starting another, as could
  606.                           be required if used by multiple managers
  607.                           concurrently."
  608.                   ::= { ifExtnsTestEntry 5 }
  609.  
  610.           ifExtnsTestCode  OBJECT-TYPE
  611.                   SYNTAX  OBJECT IDENTIFIER
  612.                   ACCESS  read-only
  613.                   STATUS  mandatory
  614.                   DESCRIPTION
  615.  
  616.  
  617.  
  618. SNMP Working Group                                             [Page 11]
  619.  
  620. RFC 1229                Interface MIB Extensions                May 1991
  621.  
  622.  
  623.                          "This object contains a code which contains
  624.                           more specific information on the test result,
  625.                           for example an error-code after a failed
  626.                           test.  Error codes and other values this
  627.                           object may take are specific to the type of
  628.                           interface and/or test.  However, one subject
  629.                           identifier:
  630.  
  631.                           testCodeUnknown  OBJECT IDENTIFIER ::= { 0 0 }
  632.  
  633.                           for use if no additional result code is
  634.                           available.
  635.                               Note that testCodeUnknown is a
  636.                           syntactically valid object identifier, and
  637.                           any conformant implementation of ASN.1 and
  638.                           the BER must be able to generate and
  639.                           recognize this value."
  640.                   ::= { ifExtnsTestEntry 6 }
  641.  
  642.  
  643.           --   Generic Receive Address Table
  644.           --
  645.           -- This group of objects is mandatory for all types of
  646.           -- interfaces which can receive packets/frames addressed to
  647.           -- more than one address.
  648.  
  649.           ifExtnsRcvAddrTable  OBJECT-TYPE
  650.                   SYNTAX SEQUENCE OF IfExtnsRcvAddrEntry
  651.                   ACCESS not-accessible
  652.                   STATUS mandatory
  653.                   DESCRIPTION
  654.                          "This table contains an entry for each
  655.                           address (broadcast, multicast, or uni-cast)
  656.                           for which the system will receive packets/
  657.                           frames on a particular interface.  When an
  658.                           interface is operating in promiscuous mode,
  659.                           entries are only required for those addresses
  660.                           for which the system would receive frames
  661.                           were it not operating in promiscuous mode."
  662.                   ::= { ifExtensions 3 }
  663.  
  664.           ifExtnsRcvAddrEntry  OBJECT-TYPE
  665.                   SYNTAX IfExtnsRcvAddrEntry
  666.                   ACCESS not-accessible
  667.                   STATUS mandatory
  668.                   DESCRIPTION
  669.                          "A list of objects identifying an address
  670.                           for which the system will accept packets/
  671.  
  672.  
  673.  
  674. SNMP Working Group                                             [Page 12]
  675.  
  676. RFC 1229                Interface MIB Extensions                May 1991
  677.  
  678.  
  679.                           frames on a particular interface."
  680.                   INDEX  { ifExtnsRcvAddrIfIndex, ifExtnsRcvAddress }
  681.                   ::= { ifExtnsRcvAddrTable 1 }
  682.  
  683.           IfExtnsRcvAddrEntry ::=
  684.                   SEQUENCE {
  685.                       ifExtnsRcvAddrIfIndex
  686.                           INTEGER,
  687.                       ifExtnsRcvAddress
  688.                           PhysAddress,
  689.                       ifExtnsRcvAddrStatus
  690.                           INTEGER
  691.                   }
  692.  
  693.           ifExtnsRcvAddrIfIndex  OBJECT-TYPE
  694.                   SYNTAX INTEGER
  695.                   ACCESS read-only
  696.                   STATUS mandatory
  697.                   DESCRIPTION
  698.                          "The value of ifIndex, defined in [4,6], of an
  699.                           interface which recognizes this entry's
  700.                           address."
  701.                   ::= { ifExtnsRcvAddrEntry 1 }
  702.  
  703.           ifExtnsRcvAddress OBJECT-TYPE
  704.                   SYNTAX PhysAddress
  705.                   ACCESS read-only
  706.                   STATUS mandatory
  707.                   DESCRIPTION
  708.                          "An address for which the system will accept
  709.                           packets/frames on this entry's interface."
  710.                   ::= { ifExtnsRcvAddrEntry 2 }
  711.  
  712.           ifExtnsRcvAddrStatus OBJECT-TYPE
  713.                   SYNTAX INTEGER {
  714.                              other(1),
  715.                              invalid(2),
  716.                              volatile(3),
  717.                              nonVolatile(4)
  718.                          }
  719.                   ACCESS read-write
  720.                   STATUS mandatory
  721.                   DESCRIPTION
  722.                          "This object has the value nonVolatile(4)
  723.                           for those entries in the table which are
  724.                           valid and will not be deleted by the next
  725.                           restart of the managed system.  Entries
  726.                           having the value volatile(3) are valid
  727.  
  728.  
  729.  
  730. SNMP Working Group                                             [Page 13]
  731.  
  732. RFC 1229                Interface MIB Extensions                May 1991
  733.  
  734.  
  735.                           and exist, but have not been saved, so
  736.                           that will not exist after the next
  737.                           restart of the managed system.  Entries
  738.                           having the value other(1) are valid and
  739.                           exist but are not classified as to whether
  740.                           they will continue to exist after the next
  741.                           restart.  Entries having the value invalid(2)
  742.                           are invalid and do not represent an address
  743.                           for which an interface accepts frames.
  744.                               Setting an object instance to one of
  745.                           the values other(1), volatile(3), or
  746.                           nonVolatile(4) causes the corresponding
  747.                           entry to exist or continue to exist, and
  748.                           to take on the respective status as regards
  749.                           the next restart of the managed system.
  750.                               Setting an object instance to the value
  751.                           invalid(2) causes the corresponding entry
  752.                           to become invalid or cease to exist.
  753.                               It is an implementation-specific matter
  754.                           as to whether the agent removes an
  755.                           invalidated entry from the table.
  756.                           Accordingly, management stations must be
  757.                           prepared to receive tabular information
  758.                           from agents that corresponds to entries not
  759.                           currently in use.  Proper interpretation of
  760.                           such entries requires examination of the
  761.                           relevant ifExtnsRcvAddrStatus object
  762.                           instance."
  763.                   DEFVAL  { volatile }
  764.                   ::= { ifExtnsRcvAddrEntry 3 }
  765.  
  766.           END
  767.  
  768. 6.  Acknowledgements
  769.  
  770.    Most of the MIB objects defined in this document were originally
  771.    proposed as a part of a MIB for management of IEEE 802.5 Token Ring
  772.    networks, as prepared by:
  773.  
  774.                Eric B. Decker, cisco Systems, Inc., and
  775.                Richard Fox, Synoptics Inc.
  776.  
  777.    In addition, the comments of the following individuals are
  778.    acknowledged:
  779.  
  780.                James R. Davin, MIT-LCS
  781.                Stan Froyd, ACC
  782.                Frank Kastenholz, Racal Interlan
  783.  
  784.  
  785.  
  786. SNMP Working Group                                             [Page 14]
  787.  
  788. RFC 1229                Interface MIB Extensions                May 1991
  789.  
  790.  
  791.                Dave Perkins, 3Com
  792.                Marshall T. Rose, PSI
  793.                Bob Stewart, Xyplex
  794.                David Waitzman, BBN
  795.                Wengyik Yeong, PSI
  796.  
  797. 7.  References
  798.  
  799.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  800.        Network Management Standards", RFC 1052, NRI, April 1988.
  801.  
  802.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  803.        Group", RFC 1109, NRI, August 1989.
  804.  
  805.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  806.        Management Information for TCP/IP-based internets", RFC 1155,
  807.        Performance Systems International, Hughes LAN Systems, May 1990.
  808.  
  809.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  810.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  811.        LAN Systems, Performance Systems International, May 1990.
  812.  
  813.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  814.        Network Management Protocol", RFC 1157, SNMP Research,
  815.        Performance Systems International, Performance Systems
  816.        International, MIT Laboratory for Computer Science, May 1990.
  817.  
  818.    [6] Rose M., Editor, "Management Information Base for Network
  819.        Management of TCP/IP-based internets: MIB-II", RFC 1213,
  820.        Performance Systems International, March 1991.
  821.  
  822.    [7] Information processing systems - Open Systems Interconnection -
  823.        Specification of Abstract Syntax Notation One (ASN.1),
  824.        International Organization for Standardization, International
  825.        Standard 8824, December 1987.
  826.  
  827.    [8] Information processing systems - Open Systems Interconnection -
  828.        Specification of Basic Encoding Rules for Abstract Notation One
  829.        (ASN.1), International Organization for Standardization,
  830.        International Standard 8825, December 1987.
  831.  
  832.    [9] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  833.        RFC 1212, Performance Systems International, Hughes LAN Systems,
  834.        March 1991.
  835.  
  836. 8.  Security Considerations
  837.  
  838.    Security issues are not discussed in this memo.
  839.  
  840.  
  841.  
  842. SNMP Working Group                                             [Page 15]
  843.  
  844. RFC 1229                Interface MIB Extensions                May 1991
  845.  
  846.  
  847. 9.   Author's Address
  848.  
  849.    Keith McCloghrie
  850.    Hughes LAN Systems, Inc.
  851.    1225 Charleston Road
  852.    Mountain View, CA 94043
  853.  
  854.    Phone:    (415) 966-7934
  855.  
  856.    EMail: kzm@hls.com
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898. SNMP Working Group                                             [Page 16]
  899.